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iMightBeLying 


Games break in the wild 

Time is money. 

The longer you’ve got errors, the less enjoyable your game. 



rR> 










WHAT WE’RE COVERING 


rR> 


1. ScriptContext. Error 

a. What are we dealing with? 

2. Error Handling and Debugging Techniques 

a. All the pcalls 

b. Threading your problems away 

c. Printing in color 

d. Studio’s tools 

e. Asserting dominance 

f. Listening to signals 

3. Analytics and Dashboards 

a. What’s available 

b. Keeping an eye on it 



ScriptContext.Error 

Anatomy of Failure 


RE¬ 


BREAKING IT DOWN 


23:23:09.694 - ReplicatedStorage.Scripts.Game.Board:63: attempt to get length of 
local 'boardString' (a nil value) 


23:23:09.695 - Stack Begin 

23:23:09.695 - Script 'ReplicatedStorage.Scripts.Game.Board', Line 63 - field load 
23:23:09.696 - Script 'ReplicatedStorage.Scripts.Game.Game', Line 76 - method constructBoard 
23:23:09.697 - Script 'ServerStorage.GameManager', Line 54 - method startNewGame 
23:23:09.697 - Script 'ServerScriptService.Main', Line 72 
23:23:09.697 - Stack End 


(Script) ServerScriptService.Main 
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RE¬ 


BREAKING IT DOWN 


23:23:09.694 - ReplicatedStorage.Scripts.Game.Board:63: attempt to get length of local 
'boardString' (a nil value) 


23:23:09.695 - Stack Begin 

23:23:09.695 - Script 'ReplicatedStorage.Scripts.Game.Board', Line 63 - field load 
23:23:09.696 - Script 'ReplicatedStorage.Scripts.Game.Game', Line 76 - method constructBoard 
23:23:09.697 - Script 'ServerStorage.GameManager', Line 54 - method startNewGame 
23:23:09.697 - Script 'ServerScriptService.Main', Line 72 
23:23:09.697 - Stack End 


(Script) ServerScriptService.Main 








The Debugger’s Toolkit 
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SILENCING THE OPPOSITION 

■ pcall() - the classic try-catch block 

■ xpcall() - formatted pcall 

■ ypcallQ - yield pcall, (non-existant) 


u 


You don’t have to deal with problems, if there never are any problems. 





SILENCING THE OPPOSITION 

■ pcall() - the classic try-catch block 

- catch some bad code 
local success, result = pcall( function() 
local local foo = 5 
print(bar.value == foo) 
end) 

print(“This line will still execute just fine”, success, result) 



it 


You don’t have to deal with problems, if there never are any problems. 





SILENCING THE OPPOSITION 


■ xpcall() - pcall, but let’s you format the output message with a second function 

local success, result = xpcall( function() 
local testStore = game.DataStoreService:GetDataStore(“Test”) 
testStore:SetAsync( playerld, { gold = 100 }) 
end, function( err) 

warn( string.format( “Failed to properly save data for %s. Threw error: %s”, playerld, err)) 
return ERROR_DATA_STORE_TIMEOUT 
end) 

if not success and result == ERROR_DATA_STORE_TIMEOUT then 
-- try again momentarily 
end 



it 


You don’t have to deal with problems, if there never are any problems. 
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SILENCING THE OPPOSITION 

ypca ll Q - schedules the function call, then blocks the thread until it is handled. 


it 


You don’t have to deal with problems, if there never are any problems. 
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SILENCING THE OPPOSITION 

■ pcall() - the classic try-catch block 

■ xpcall() - formatted peal I 

■ ypcallQ - yield pcall, (non-existant) 


u 


You don’t have to deal with problems, if there never are any problems. 
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CLEVER THREADING 

■ spawn() - creates a new thread for the provided 
code block 

spawn( function() 

PlayersService:GetUserThumbnailAsync(userld, 

THUMB_TYPE, 

THUMB_SIZE) 

end) 

print( “Doesn’t matter if ThumbnailAsync throws errors!”) 



7 really, really don’t want to deal with this (but I don’t mind the error in the logs)’’ 
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CAVEMAN DEBUGGING 

■ print(...) - dumps a message to the console 

■ warn(...) - a colorful alert that something could be bad soooon 


Hello world! 

18:51:29.798 - Unexpected inputs : 5 and nil 
is this broken yet? 
how about now 
now? 

18:51:30.081 - ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number 


‘Just put print statements everywhere” 




CAVEMAN DEBUGGING 

■ print(...) - dumps a message to the console 

print( “This supports all types : foo, fooString, foolnt, 
fooTable, fooBool, fooNil ) 



Hello world! 

18:51:29.798 - Unexpected inputs : 5 and nil 
is this broken yet? 
how about now 
now? 

18:51:30.081 - ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number 


‘Just put print statements everywhere” 





CAVEMAN DEBUGGING 


warn(...) - a colorful alert that something could be bad soooon 


warn( “This also supports all type and variadics”) 


Hello world! 

18:51:29.798 - Unexpected inputs : 5 and nil 
is this broken yet? 
how about now 
now? 

18:51:30.081 - ServerStoraee.Folder.HelloW 


‘Just put print statements everywhere 
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CAVEMAN DEBUGGING 

■ print(...) - dumps a message to the console 

■ warn(...) - a colorful alert that something could be bad soooon 


Hello world! 

18:51:29.798 - Unexpected inputs : 5 and nil 
is this broken yet? 
how about now 
now? 

18:51:30.081 - ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number 


‘Just put print statements everywhere” 




STUDIO TOOLING 


110 

111 — promises 

112 ^ local function pushController(controller, parent, zlndex, locale, isAnimated) 

113 local d = deferred.new() 

114 

115 — run through all of the delegate actions 

116 v controller:viewDidLoad():next( 

117 N ' function (_) 

118 controller:setLocalization(locale) 

115 • controller:setEnabled (true) 

120 controller:setZlndex(zlndex) 

121 | controller:setParent(parent) 

122 return controller:viewWillAppear() 

123 end): next( 

124 v function{_) 

125 return controller:viewDidAppear() 

126 end): next( 

127 v function (_) 

128 d:resolve (nil) 

125 end, function (err) 

130 debugWarn ("PushController Error :\n", err) 

131 end) 

132 

133 return d 

134 end 



An easier way to step through your problems 


■ Breakpoints - pauses the game 
when the code line gets hit. 

■ Watches - attaches an observer to a 
variable / value in a script 


VIEW PLUGINS SCRIPT MENU 



HI Script An a lysis 

^ Callstack 

:rj Task Scheduler 

^ Team Create 

ser Q Command Bar 

HI Watch 

Script Performance 

Q Script Recovery 

Breakpoints 

PI Performance 

4% Find Results 

>2 Terrain Editor 

Show 








KICKING YOUR OWN BUTT 

■ error(message, stackOffset) - throw your own custom error 

■ assert(condition, messageOnError) - conditionally throw your own custom error 


No one breaks my code but me! 





KICKING YOUR OWN BUTT 

■ error(message, stackOffset) - throw your own custom error 

function printString( input) 
if type( input) ~= “string” then 

-- tell the function that called evaluateString that they messed up 
error( “Passed an invalid value to printstring”, 1) -- pass the error up the stack 1 layer 
end 

print( input) 
end 


rR> 


No one breaks my code but me! 





KICKING YOUR OWN BUTT 

■ assert(condition, messageOnError) - conditionally throw your own custom error 
function printString( input) 

assert( type(input) == “string”, “Expected input to be a string, not a ”type(input)) 
print( string.format(“This is a string : %s”, input)) 
end 


No one breaks my code but me! 





KICKING YOUR OWN BUTT 

■ error(message, stackOffset) - throw your own custom error 

■ assert(condition, messageOnError) - conditionally throw your own custom error 


No one breaks my code but me! 





SMOKE SIGNALS 

■ LogService.MessageOut - listens for anything put into the console 

■ ScriptContext.Error - tells you when errors are thrown 


rR> 


Callback me maybe? 





rR> 


SMOKE SIGNALS 

■ LogService.MessageOut - fires anytime something is posted to the logs 

game.LogService.MessageOut:connect( function( message, msgType) 
if msgType == Enum.MessageType.Messagelnfo then 
-- someone used print() 

elseif msgType == Enum.MessageType.Messagewarning then 
-- someone used warn() 

elseif msgType == Enum.MessageType.MessageError then 
-- someone used error() 
end 
end) 


Callback me maybe? 





SMOKE SIGNALS 

■ ScriptContext.Error - fires anytime an error is thrown 

game.ScriptContext.Error:connect( function( message, stackTrace, container) 
-- log the error 


end) 


rR> 


Callback me maybe? 





SMOKE SIGNALS 

■ LogService.MessageOut - listens for anything put into the console 

■ ScriptContext.Error - tells you when errors are thrown 


rR> 


Callback me maybe? 





Keeping an Eye on the Kids 

Building Tools for Mass Surveillance 



LEVERAGING ANALYTICS FOR FUN AND PROFIT 



Maybe avoid these 

° Discord 
° Trello 
= Twilio 
° Slack 


Better options 
° PlayFab 
- Google Analytics 
° Amazon S3 



Google Analytics 





REPORTING YOUR ERRORS 


Simply drop it into ServerScriptService: 

https://www.roblox.com/librarv/3530026985/ErrorReporter 

Source Code available : 

https://github.com/Kvlaaa/RobloxLuaErrorReporter 


ErrorReporter 

By ItReallylsKyler Q Item Owned 


This item is not currently for sale. 
Model 

Genres All 


Inventory 


Updated Jul 24, 2019 

Description A drag and drop solution for reporting 
analytics. 


0 t3o o9 


no 




-- in a nutshell... 

game.ScriptContext.Error:connect( function/ msg, stack, container) 

— anonymize player info from the msg and stack 

— send the data over the wire to your analytics backend 

game:HttpService:RequestAsync( <THE_CLOUD>.) 

end) 


ServerScriptService 
v g, ErrorReporter 
> Bs Src 

^ Config 

% README 










<S) PI.AYFAB 


testCreateTitleApi ® 



PlayFab 

To configure PlayFab, just follow these 
instructions: 

https://developer.roblox.com/en-us/articles/usinq-the-analvtics-service 



Jtput i? X 

09:47:09.285- DataModel Loadinghttps://asset me.roblox.com/Asset/?id=95206881 


! game.AnalyticsService.ApiKey = "<YOUR_API_KEY>" 


-- Log some errors! 
local eventData = { 

message = “ServerStorage.Folder.HelloWorld:28 : attempt to compare nil with number” 
stack = V, 

origin = “Game.ServerScriptStorage.Script” 

} 

local AnalyticsService = game:GetService(“AnalyticsService”) 
AnalyticsService:SendEvent(“Errors-0.0.1”, eventData) 


rR> 




<§) My Studios and Titles • PlayFab X + 


0 ft https://developer.rblx.playfab.com/en-US/my-games 
I;- Apps JIRA «|L ROBLOX Slack Q Analytics Q Release Q Dev Portals [] Settings Q 


ROBLDX 


My Studios and Titles 


testApi 





ROBLDX testApi 


IM 


W 

Co 

© 


Dashboard 


Overview 


Players 


Overview 


Analytics 



Settings 

Admin 

Help 


UNIQUE USERS 

Amount 

Change 

Last 24 hours 

1 


1 day ago 

0 

+100.00% 

7 days ago 

0 

+100.00% 

1 

LAST 30 DAYS 

1 

LAST 24 HOURS 


LOGINS 


Amount Change 


Last 24 hours 2 

1 day ago 0 

7 days ago 0 


+ 100 . 00 % 

+ 100 . 00 % 


o ] * * -— 

12:00 15:00 18:00 21:00 00:00 03:00 06:00 09:00 
Jul 26 



Time period 4h 24h 3d 7d 4w 


API CALLS 


Filter v 
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2 


12:00 15:00 18:00 21:00 00:00 03:00 06:00 09:00 
Jul 26 


CLOUD SCRIPT PROCESSING TIMES 


12:00 15:00 18:00 21:00 00:00 03:00 06:00 09:00 
Jul 26 


NEW USERS 

Amount 

Change reports 

Yesterday 

Last month 

Last 24 hours 

1 

Unique users 



1 day ago 

1 

New users 



7 days ago 

0 

+100.00% API calls 




1 - 


0 


12:00 15:00 18:00 21:00 00:00 03:00 06:00 09:00 
Jul 26 
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ROB LEIX | testApi 


)[][][] Dashboard 

Trends (Preview) Event History Reports 

Players 

Trends 

liil /0 Analytics 


Settings 

Today vs. 7 days agoC3 

Updated July 25,2019 

Lq Admin 


(?) Hel P 

MAU rolling 30 DAU New players 

2 2 2 

0 . 00 % 0 . 00 % 0 . 00 % 

7 day trends 

ACTIVE PLAYERS ~ MAU rolling 30 ▼ 

Average this period 

2 

0 . 00 % 

Average last period 

o 

Average stickiness 

100 

-> 100 . 00 % 

o • 

Jul25 


NEW PLAYERS ^ 

Total this period 


| Last 7 days * |-~ All platforms 


Average screen time 

Om Os 

0% 


■ MAU rolling 30 ■ MAU last period 


Jul 26 


■ New players ■ Total last period 
















ROBLDX | testApi 

































NumbdPof Events 


Event History Chart 


10 



player_logged_in (2) H player_linked_account (1) H player_created (1) player_added_title (1) 

entityjoggedjn (5) K Player_Disconnected (2) H Errors-0.0.1 (6) 


□ Show one bar per day □ Auto-refresh 


Deselect all 



















Event name 


> 


“ gj Player_Disconnected 




Errors-0.0.1 

Errors-0.0.1 

Errors-0.0.1 

Errors-0.0.1 

entityjoggedjn 

player_logged_in 

CustomServer 

Unknown city, US (NA) 

entityjoggedjn 

Errors-0.0.1 

entityjoggedjn 

player_created 















Errors-0.0.1 


> 


^ entity_logged_in 

p playerjoggedjn 
° CustomServer 

Unknown city, US (NA) 

entity_logged_in 

Errors-0.0.1 



JSON 

Entityld: 918F5FCB 
EntityType: title 
EntityLineage_title: 918F5FCB 
EntityLineage_master_player_account: 


{ 


"origin": "Game.ServerScriptService.Script", 

"stack": "ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number". 


"error": "ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number" 

} 














Numbed of Events 


Event History Chart 


10 


I I 

■ _ ■ 

■ 


player_logged_in (2) H player_linked_account (1) player_created (1) I player.added .title (1) 

entity.logged.in (5) H Player.Disconnected (2) H Errors-0.0.1 (6) 




□ Show one bar per day □ Auto-refresh 


Deselect all 
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Google Analytics 


Google Analytics Events 


local category = “Errors-”.. GAME_VERSION 

local action = “ServerStorage.Folder.HelloWorld:28 : attempt to compare nil with 
local label = “ <stack trace> ” 

local value = 1 // optional count of how many times the error threw 

gaReporter:sendEvent( category, action, label, value) 




Roblox Lua 

Property Settings 

3 Property Settings 

Basic Settings 


Tracking Id 

User Management 


< > Tracking Info 

Property Name M 

Roblox Lua M 

PRODUCT LINKING 

Default URL M 

|=| Google Ads Linking 

https:// ▼ www.wlox.com 

&=l AHRpn<;p 1 jnkjnn 

_„ _ 1 _ 


number” 


ServerScriptService 
v gg ErrorReporter 

> ^ Src 

Config 

% README 



RE P ORT_TO_GOOGLE_ANALYTICS = true, 
GOOGLE_ANALYTICS_TRACKING_ID = "UA-00000000-00" , 
PRINT SUCCESSFUL GOOGLE ANALYTICS = true. 









Try searching “How to set up a property” 


I All accounts > GoBlox 

Jl Analytics AN Web site Data _ 

A Home 
S? Customization 
REPORTS 
© Realtime 
_ Audience 
Acquisition 
H Behavior 
p Conversions 


Google Analytics Home 


Users Sessions 

42 42 


Bounce Rate Session Duration 

0% 0m 11 s 


40 



Last 28 days ▼ AUDIENCE OVERVIEW 


30 

20 

10 

0 

> 


How do you acquire users? 


Traffic Channel Source / Medium Referrals 


50 

HH 40 

m 30 

O Discover 20 

0 Admin 


< 


10 






































# §| Analytics 

# Home 

► ■? Customization 
REPORTS 

► © Realtime 

► » Audience 

► }-• Acquisition 
▼ H Behavior 

Overview 
Behavior Flow 

► Site Content 

► Site Speed 

► Site Search 
▼ Events 

Overview 
Top Events 
Pages 

Events Flow 

► Publisher 
Experiments 

► ^ Conversions 


All accounts > GoBlox 


All Web Site Data - Q - Try searchi "« ,or ' audien « dvdrvidw ' 

Events Overview 0 

O a11 Users + Add Segment 

100 00% Unique Events 


0 :: © ; <$> 


B SAVE i±j EXPORT SHARE gj INSIGHTS 

Jul 20,2019 - Jul 31,2019 ▼ 


Total Events ▼ vs. Select a metric 


1 Day 


Hourly Day Week Momh 



Total Events 

317 


Top Events 


Event Category 

Event Action 
Event Label 


Unique Events 

83 


Event Value 

0 


Avg. Value 

0.00 


Sessions with Event 

42 


Events / Session with Event 

7.55 


Event Category 


Total Events % Total Events 


2 | 0.63% 


view full report 

This report was generated on 8/5/19 at 2:36:04 PM - Refresh Report 


© 2019 Google | Analytics Home | Terms of Service | Privacy Policy | Send Feedback 


O Discover 
O Admin 






















Event Category 

Total Events 

% Total Events 

1. 0.0.1 

315 

99.37% 

2. 1.0.0 

2 

| 0.63% 


view full report 










ALL » EVENT CATEGORY: 0.0.1 ^ 

o 


All Users 

97.59% Unique Events 


*- Add Segment 


Explorer 


Jul 20,2019 - Jul 31,2019 ▼ 


Event Site Usage Ecommerce 


VS. Select a metric 


• Total Events 


Primary Dimension: Event Action Event Label Event Category 


Da< 

Week 

Month 

- 



Secondary dimension Sort Type: Default ▼ 


Qk advanced ffl © i t | ITTT [ 



Event Category 

Total Events (?) 4' 

Unique Events 

Event Value 

Avg. Value 



315 

81 

0 

0.00 



% of Total: 99.37% (317) 

% of Total: 97.59% (83) 

% of Total: 0.00% (0) 

Avg for View: 0.00 (0.00%) 

□ 

1. 0.0.1 

315(100.00%) 

81(100.00%) 

0 (0.00%) 

0.00 









































ALL » EVENT CATEGORY: 0.0.1 3 


Jul 20,2019-Jul 31,2019 


O AII Users 

97.59% Unique Events 

Explorer 

Event Site Usage Ecommerce 


+ Add Segment 



Primary Dimension: Event Action Event Label Other ▼ 


Secondary dimension ▼ Sort Type: Default ▼ ^ ~ advanced H O ^ "t ilTT 



Event Action 

Total Events ?) 4- 

Unique Events 

Event Value 

Avg. Value 



315 

81 

0 

0.00 



% of Total: 99.37% (317) 

% of Total: 97.59% (83) 

% of Total: 0.00% (0) 

Avg for View: 0.00 (0.00%) 

□ 

1. Workspace.ErrorReporter.Src.Util.Deferred:146: attempt to concatenate field 'value' (a nil value) 

49 (15.56%) 

2 (2.47%) 

0 (0.00%) 

0.00 

□ 

2. C stack overflow 

30 ( 9 . 52 %) 

1 (1.23%) 

0 (0.00%) 

0.00 

□ 

3. Players <Player>.PIayerGui.ScreenGui.LocalScript:4: error in a local script 

30 ( 9 . 52 %) 

29 (35.80%) 

0 (0.00%) 

0.00 

□ 

4. Workspace.ErrorReporter.Src.Util.Deferred:146: bad argument #2 to 'format' (string expected, got table) 

30 ( 9 . 52 %) 

1 (1.23%) 

0 (0.00%) 

0.00 

□ 

5. Workspace.ErrorReporter.Src.Util.Deferred:146: attempt to concatenate local d' (a table value) 

25 ( 7 . 94 %) 

1 (1.23%) 

0 (0.00%) 

0.00 

□ 

6. Players.<Player>.PlayerGui.ScreenGui.Frame.LocalScript:l4: 

19 ( 6 . 03 %) 

4 (4.94%) 

0 (0.00%) 

0.00 

□ 

7. ServerScriptService.ErrorReporter.Src.Util.getFullPath:11: bad argument #2 to 'format' (string expected, got Object) 

12 ( 3 . 81 %) 

2 (2.47%) 

0 (0.00%) 

0.00 

a 

8. ServerScriptService.Script:9: Stagnato : pokemon are real 

12 ( 3 . 81 %) 

1 (1.23%) 

0 (0.00%) 

0.00 

□ 

9. Players.<Player>.PlayerGui.ScreenGui.Frame.LocalScript:14: when will the coffee be hot 

11 ( 3 . 49 %) 

1 (1.23%) 

0 (0.00%) 

0.00 

a 

10. ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number 

11 ( 3 . 49 %) 

11 (13.58%) 

0 (0.00%) 

0.00 

































ALL * EVENT CATEGORY: 0.0.1 ▼] » EVENT ACTION: ServerStorage.Folder.HelloWorld:28: attempt to compare nil with number ▼ » EVENT LABEL: ServerStorage.Folder.HelloWorld, line 28 - field deepError ServerScriptService.Script, line 24 ▼ Jul 20 201 9 - Jul 31 2019 ▼ 
AI1 Users + Add Segment 

7.23% Unique Events 


Explorer 


Event Site Usage Ecommerce 

Total Events ▼ vs. Select a metric 


• Total Events 



Primary Dimension: Event Label Other ▼ 


Secondary dimension ▼ Sort Type: Default ▼ 


Q* advanced H O i t ITT7 


Event Label 


1. ServerStorage.Folder.HelloWorld, line 28 - field deepError ServerScriptService.Script, line 24 


Total Events 


4” Unique Events Event Value 


Avg. Value 


6 

% of Total: 1.89% (317) 

6 ( 100 . 00 %) 


% of Total: 7.23% (83) 
6 ( 100 . 00 %) 


% of Total: 0.00% (0) 
0 ( 0 . 00 %) 


0.00 

Avg for View: 0.00 (0.00%) 








































Try searching “How to set up a property” 


I All accounts > GoBlox 

Jl Analytics AN Web site Data _ 

A Home 
S? Customization 
REPORTS 
© Realtime 
_ Audience 
Acquisition 
H Behavior 
p Conversions 


Google Analytics Home 


Users Sessions 

42 42 


Bounce Rate Session Duration 

0% 0m 11 s 


40 



Last 28 days ▼ AUDIENCE OVERVIEW 


30 

20 

10 

0 

> 


How do you acquire users? 


Traffic Channel Source / Medium Referrals 


50 

HH 40 

m 30 

O Discover 20 

0 Admin 
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10 







































Wrapping up 



IN CONCLUSION 

■ Fail fast: use asserts and error on bad code states 

■ Reserve pcalls for error prone code outside of your control, and always handle the error 

■ Track your errors 





RESOURCES 

■ Roblox Lua Error Reporter (GIT) - https://aithub.com/Kvlaaa/RobloxLuaErrorReDorter 

■ Roblox Lua Error Reporter (Catalog) - 
https://www.roblox.com/librarv/3530045594/ErrorReporter 

■ Roblox Developer Hub - https://developer.roblox.com/ 

■ StackOverflow - https://stackoverflow.com/auestions/taaaed/roblox 

■ ScriptingHelpers - https://scriptinahelpers.ora/ 




Thank you for your time. 







Any Questions? 



